Release 10.1A: OpenEdge Development:
Progress 4GL Reference

ERROR attribute

A compile-time or run-time error condition.

Data type: LOGICAL

Access: Readable

Applies to: Asynchronous request object handle, Buffer object handle, COMPILER system handle, ERROR-STATUS system handle, ProDataSet object handle, Temp-table object handle

For the asynchronous request object handle, the ERROR attribute indicates that the ERROR condition was encountered during the processing of an AppServer or Web Server request. If the COMPLETE attribute is FALSE, the value of this attribute is the Unknown value (?). This attribute is set immediately before the event procedure is executed.

For the COMPILER system handle, the ERROR attribute indicates whether an error occurred in the preceding compilation. If no error occurred in the preceding compilation, the value of ERROR is the Unknown value (?).

For the ProDataSet object handle, Temp-table object handle, and Buffer object handle, the ERROR attribute indicates whether an error occurred during a FILL or SAVE-ROW-CHANGES operation. The ERROR attribute is writeable for a ProDataSet object.

The ERROR attribute corresponds to the ERROR function.

For a ProDataSet object handle or a Temp-table object handle, the ERROR attribute is reset to FALSE when one of the following methods removes the object’s before-image records:

FILL( ) method
EMPTY-DATASET( ) method
MERGE-CHANGES( ) method
ACCEPT-CHANGES( ) method
REJECT-CHANGES( ) method

For the Buffer object handle, this attribute causes the row to be backed out rather than merged with the MERGE-CHANGES( ) method or the MERGE-ROW-CHANGES( ) method.

This attribute is marshalled between the client and the AppServer.

For the ERROR-STATUS system handle, the ERROR attribute indicates whether the Progress ERROR condition was raised in the most recent statement that used the NO-ERROR option. If no ERROR condition was raised in that statement, the value of the ERROR attribute is FALSE.

Note: Statements such as COMPILE handle errors as part of their normal function that do not raise the Progress ERROR condition. For example, the COMPILE statement does not raise the ERROR condition when it encounters compilation errors in a procedure.